/*
 * 版权所有 (C) 2015 知启蒙(ZHIQIM) 保留所有权利。[遇见知启蒙，邂逅框架梦]
 * 
 * https://zhiqim.org/project/zhiqim_framework/zhiqim_httpd.htm
 *
 * Zhiqim Httpd is licensed under Mulan PSL v2.
 * You can use this software according to the terms and conditions of the Mulan PSL v2.
 * You may obtain a copy of Mulan PSL v2 at:
 *          http://license.coscl.org.cn/MulanPSL2
 * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
 * EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
 * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
 * See the Mulan PSL v2 for more details.
 */
package org.zhiqim.httpd.context.rule;

import org.zhiqim.httpd.HttpRequest;

/**
 * 定义替换权限接口，通过请求和指定参数验证，成功返回要求的URL，否则返回验证权限URL，举例:
 * <a href="${ChkPermissionRule.replace(request, "delete", "/delete.htm")}"><button type="button" class="blue">删除</button></a></#if>
 *
 * @version v1.0.0 @author zouzhigang 2014-3-21 新建与整理
 */
public interface ReplacePermissionRule
{
    /**
     * 替换权限接口定义，当参数验证未通过则返回指定的URL
     * 
     * @param request       请求的上下文环境
     * @param permission    请求权限参数信息
     * @param url           请求的URL信息
     * @return              检验之后的有效信息
     * @throws Exception    可能的异常
     */
    public String replace(HttpRequest request, String permission, String url) throws Exception;
}
